home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / pmlpp140.zip / SRC / pmlpp.ipf < prev    next >
Text File  |  1997-08-14  |  8KB  |  179 lines
  1. :userdoc.
  2. :title.Help for PMLPP
  3. :docprof  toc=123456 .
  4. :h1 id=ID@1.Legal Notice
  5. Copyright (C) 1997 James R. Louvau This program is free software; you can
  6. redistribute it and/or modify it under the terms of the GNU General Public
  7. License as published by the Free Software Foundation; either version 2 of the
  8. License, or (at your option) any later version. This program is distributed in
  9. the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the
  10. implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See
  11. the GNU General Public License for more details. You should have received a copy
  12. of the GNU General Public License along with this program; if not, write to the
  13. Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 
  14. 02111-1307, USA. You may contact the author of PMLPP at&colon. E-mail    
  15. &colon. jim@vwm.com Snail-mail &colon. Jim Louvau 3437 335th St. West Des
  16. Moines, IA 50266 
  17. :h1 id=ID@2.Overview
  18. :i1.Overview
  19. PMLPP's main window consists of three main elements&colon. 
  20. :ol.
  21. :li.:link reftype=hd refid=ID@3.A pushbutton/icon.:elink. 
  22. :li.:link reftype=hd refid=ID@4.A message-count display window.:elink. 
  23. :li.:link reftype=hd refid=ID@5.A popup/context menu.:elink. 
  24. :eol.
  25. :note.You can drag the main window by clicking and holding either mouse button. 
  26. :h2 id=ID@3.Refresh Button
  27. :i1.Refresh Button
  28. Clicking on the refresh button results in one of two actions. If you have defined
  29. a mailreader, and there is mail pending, PMLPP will attempt to launch your reader.
  30. Failing that, PMLPP will poll the server immediately if possible.
  31. The icon background of the button will also reflect PMLPP's current
  32. status. If the background is :color fc='PaleGray'
  33. bc='default'.GRAY:color fc='Default' bc='Default'., there is no mail on the
  34. server. If :color fc='Green' bc='default'.GREEN:color fc='Default'
  35. bc='Default'., one or more messages are available. If :color
  36. fc='Red' bc='default'.RED:color fc='Default' bc='Default'., something has
  37. malfunctioned (see :link reftype=hd refid=ID@18.Error Codes:elink.). 
  38. :h2 id=ID@4.Message Count Window
  39. :i1.Message Count Window
  40. This is the small window below the refresh/icon button. One of two things will
  41. appear here; a message count as of the last poll, or an error code. 
  42. :h2 id=ID@5.Context Menu
  43. :i1.Context Menu
  44. PMLPP uses a combination system and context/popup menu. Clicking the
  45. context-menu mouse button (usually button 2 or the right one) anywhere over the
  46. main window will bring up the menu. Use the ":link reftype=hd
  47. res=263.Properties:elink." option to open a configuration dialog. 
  48. :h1 id=ID@6 res=263.Configuration
  49. :i1.Configuration
  50. The following options are available for configuring PMLPP&colon. 
  51. :sl.
  52. :li.:link reftype=hd res=265.Play Sound.:elink. 
  53. :li.:link reftype=hd res=267.Minutes.:elink. 
  54. :li.:link reftype=hd res=271.Server.:elink. 
  55. :li.:link reftype=hd res=273.Port.:elink. 
  56. :li.:link reftype=hd res=275.User.:elink. 
  57. :li.:link reftype=hd res=277.Password.:elink. 
  58. :li.:link reftype=hd res=280.Program.:elink. 
  59. :li.:link reftype=hd res=282.Options.:elink. 
  60. :li.:link reftype=hd res=284.Directory.:elink. 
  61. :esl.
  62. :h2 id='265' res=265.Play Sound
  63. :i1.Play Sound
  64. If this box is checked, PMLPP will beep :color fc='Red' bc='default'.ONCE
  65. :color fc='Default' bc='Default'.when it detects the :color
  66. fc='Red' bc='default'.first :color fc='Default' bc='Default'.message; i.e., when
  67. the message count changes from 0 (zero) to 1 (one). 
  68. :h2 id='267' res=267.Seconds
  69. :i1.Seconds
  70. "Click" on the arrow-buttons or type in the number of :color fc='Red'
  71.  bc='default'.SECONDS :color fc='Default' bc='Default'.PMLPP should pause
  72. between polls to the pop server. 
  73. :note.The valid range is :color fc='Red' bc='default'.1
  74. :color fc='Default' bc='Default'.to :color fc='Red' bc='default'.86400
  75. :color fc='Default' bc='Default'.(24 hours). 
  76. :h2 id='271' res=271.Server
  77. :i1.Server
  78. Your pop server's address as a domain name like&colon. 
  79. :xmp.
  80. mail.mydomain.com
  81. :exmp.
  82. or as an I.P. address like&colon. 
  83. :xmp.
  84. 167.142.225.5
  85. :exmp.
  86. :h2 id='273' res=273.Port
  87. :i1.Port
  88. The POP3 "service" port (usually 110). 
  89. :note.If set to :color fc='Red' bc='default'.0
  90. (zero):color fc='Default' bc='Default'., PMLPP will look up the appropriate
  91. value in your host's "services" file. This is your best bet for staying out of
  92. trouble. 
  93. :h2 id='275' res=275.User
  94. :i1.User
  95. You, silly! The name you use to logon to the pop server. 
  96. :caution.
  97. Your user name is almost always :color fc='Red' bc='default'.CASE SENSITIVE!
  98. :color fc='Default' bc='Default'.
  99. :ecaution.
  100. :h2 id='277' res=277.Password
  101. :i1.Password
  102. The password you use to logon to the pop server. 
  103. :caution.
  104. As with your user name, passwords are almost always :color fc='Red'
  105. bc='default'.CASE SENSITIVE! :color fc='Default' bc='Default'.
  106. :ecaution.
  107. :h2 id='292' res=292.Save Password
  108. :i1.Save Password
  109. If this box is checked, PMLPP will save your password in its INI file, where
  110. somebody could conceivably see it (INI files are binary, but text in strings is
  111. visible). If left unchecked, you will be prompted for your password when PMLPP
  112. is launched.
  113. :h2 id='293' res=293.Force IP
  114. :i1.Force IP
  115. If this box is checked, and you have entered a (numerically) valid I.P. address
  116. in the server field, PMLPP will ignore any errors returned from DNS lookup, and
  117. attempt to use this I.P. address. In other words, :hp2.YOU :ehp2.are assuming
  118. responsibility for the correctness of the address. 
  119. :h2 id='280' res=280.Program
  120. :i1.Program
  121. The pathname of your mail-reader program. You only need to set this if you would
  122. like to be able to launch your mail-reader from PMLPP's menu. 
  123. :h2 id='282' res=282.Options
  124. :i1.Options
  125. Command-line option to pass to the reader, if any. 
  126. :h2 id='284' res=284.Directory
  127. :i1.Directory
  128. What directory to change to before running the reader. 
  129. :h1 id=ID@18.Error Codes
  130. :i1.Error Codes
  131. The following codes may appear in the "message count" window&colon. 
  132. :dl.
  133. :dt.ADDR 
  134. :dd.
  135. :dt.
  136. :dd.PMLPP was unable to resolve the server name/address (gethostbyname() and/or
  137. gethostbyaddr() failed). 
  138. :dt.SOCK 
  139. :dd.
  140. :dt.
  141. :dd.PMLPP was unable to obtain a new socket from the system (socket() failed). 
  142. :dt.CONN 
  143. :dd.
  144. :dt.
  145. :dd.PMLPP was unable to connect to the server (connect() failed). 
  146. :dt.SRVR 
  147. :dd.
  148. :dt.
  149. :dd.The server won't talk to PMLPP. It isn't running, or for some reason (it's
  150. too busy, etc.) refuses to accept commands (we timed out waiting for it to
  151. "talk" to us, or the server didn't respond with "+OK"). 
  152. :dt.USER 
  153. :dd.
  154. :dt.
  155. :dd.The server has rejected your user name; i.e., it doesn't like you or doesn't
  156. know who you are. Make sure you've configured your name correctly. 
  157. :dt.PASS 
  158. :dd.
  159. :dt.
  160. :dd.The server has rejected your password. Make sure you've entered it
  161. correctly. 
  162. :dt.STAT 
  163. :dd.
  164. :dt.
  165. :dd.The server doesn't want to give us statistics. You should NEVER see this,
  166. and if you do, it probably means something on the server end is broken. 
  167. :dt.VALU 
  168. :dd.
  169. :dt.
  170. :dd.PMLPP couldn't parse the statistics string returned by the server. You
  171. should never see this either. 
  172. :dt.
  173. :dd.
  174. :edl.
  175. :note.Some of the above error codes may appear erroneously if something happens
  176. to the connection in mid "conversation." In other words, you might see a "PASS"
  177. error if PMLPP was waiting for the server to acknowledge your password, and the
  178. connection was suddenly broken. 
  179. :euserdoc.